<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>GROOPS - miscAccelerationsType</title>

    <!-- JQuery and Popper -->
    <script src="https://code.jquery.com/jquery-3.4.1.slim.min.js" integrity="sha384-J6qa4849blE2+poT4WnyKhv5vZF5SrPo0iEjwBvKU7imGFAV0wwj1yYfoRSJoZ+n" crossorigin="anonymous"></script>
    <script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.0/dist/umd/popper.min.js" integrity="sha384-Q6E9RHvbIyZFJoft+2mJbHaEWldlvI9IOYy5n3zV9zzTtmI3UksdQRVvoxMfooAo" crossorigin="anonymous"></script>

    <!-- Bootstrap -->
    <!-- https://getbootstrap.com/docs/4.1/examples/ -->
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/js/bootstrap.min.js" integrity="sha384-wfSDF2E50Y2D1uUdj0O3uMBJnjuUD4Ih7YwaYd1iqfktj0Uod8GCExl3Og8ifwB6" crossorigin="anonymous"></script>
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">

    <!-- Mathjax -->
    <script type="text/x-mathjax-config">
    MathJax.Hub.Config({tex2jax: {inlineMath: [ ['$','$'] ],
                                  displayMath: [ ["\\[","\\]"] ],
                                  processEscapes: true},
                        TeX:     {Macros: {M: ["{\\mathbf #1}",1]},
                                  equationNumbers: {autoNumber: "all"}  }});
    </script>
    <script async src="https://cdn.jsdelivr.net/npm/mathjax@2.7.7/MathJax.js?config=TeX-AMS_CHTML" integrity="sha384-e/4/LvThKH1gwzXhdbY2AsjR3rm7LHWyhIG5C0jiRfn8AN2eTN5ILeztWw0H9jmN" crossorigin="anonymous"></script>

    <!-- lunr -->
    <script src="https://cdn.jsdelivr.net/npm/lunr@2.3.8/lunr.min.js" integrity="sha384-vRQ9bDyE0Wnu+lMfm57BlYLO0/XauFuKpVsZPs7KEDwYKktWi5+Kz3MP8++DFlRY" crossorigin="anonymous"></script>

    <!-- Mustache -->
    <script src="https://cdn.jsdelivr.net/npm/mustache@4.0.1/mustache.min.js" integrity="sha384-0PLEZVBpOQ+Kqw3anJWSNWvRxpEFt02tSpBvyRsA4WcvX/OTldWdXxGLVLvh954H" crossorigin="anonymous"></script>

    <!-- GROOPS Stylesheet -->
    <link rel="stylesheet" href="static/groops.css"/>

    <!-- icon -->
    <link rel="icon" href="static/groops_icon.png">

</head>
<body>
    <header>
        <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
            <div class="container">
              <a class="navbar-brand" href="index.html"><img class="logo" src="static/groops_white.svg"></a>
              <div class="collapse navbar-collapse" id="mainNavbar">
                <ul class="navbar-nav mr-auto">
                  <li class="nav-item">
                    <a class="nav-link" href="programType.html">Programs</a>
                  </li>
                  <li class="nav-item">
                    <a class="nav-link" href="classes.html">Classes</a>
                  </li>
                  <li class="nav-item">
                    <a class="nav-link" href="general.parser.html">Parser</a>
                  </li>
                  <li class="nav-item">
                    <a class="nav-link" href="general.fileFormat.html">File Formats</a>
                  </li>
                </ul>
              </div>
                <form class="form-inline my-2 my-lg-0" action="search.html" id="searchTools">
                  <input class="form-control mr-sm-2" placeholder="Search" name="searchTerms" method="GET" value="" type="text" id="searchBox">
                  <button class="btn btn-secondary my-2 my-sm-0" type="submit" id="searchButton">Search</button>
                </form>
              <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#mainNavbar" aria-controls="mainNavbar" aria-expanded="false" aria-label="Toggle navigation" style="">
                <span class="navbar-toggler-icon"></span>
              </button>
            </div>
        </nav>
    </header>
    <main class="container px-0 pt-2 top-buffer">
        <div id="content" class="container">
            
<h1 id="miscAccelerationsType">MiscAccelerations</h1><p>
This class gives the non conservative forces acting on satellites.
</p>

<h2 id="relativisticEffect">Relativistic effect</h2><p>
The relativistic effect to the acceleration of an artificial Earth satellite
according to IERS2010 conventions.</p><p>The macro model and the attitude of the satellite is not needed.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">beta</div></div></td><td>double</td><td>PPN (parameterized post-Newtonian) parameter</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">gamma</div></div></td><td>double</td><td>PPN (parameterized post-Newtonian) parameter</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">J</div></div></td><td>double</td><td>Earth’s angular momentum per unit mass [m**2/s]</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">GM</div></div></td><td>double</td><td>Geocentric gravitational constant</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor</td></tr>
</table>

<h2 id="RadiationPressure">RadiationPressure</h2><p>
This class computes acceleration acting on a satellite caused by Solar and Earth radiation pressure
and thermal radiation.</p><p>Solar radiation pressure: The solar constant at 1 AU can be set via <strong class="groops-config-element">solarFlux</strong>.
The <strong class="groops-config-element">factorSolarRadation</strong> can be used to scale the computed acceleration of the direct solar radiation.</p><p>Earth radiation pressure:
Input are a time series of gridded albedo values (unitless) as <a class="groops-class" href="fileFormat_griddedDataTimeSeries.html">inputfileAlbedoTimeSeries</a>
and a time series of gridded longwave flux (W/m$^2$) as <a class="groops-class" href="fileFormat_griddedDataTimeSeries.html">inputfileLongwaveFluxTimeSeries</a>.
Both files are optional and if not specified, the respective effect on the acceleration is not computed.
The <strong class="groops-config-element">factorEarthRadation</strong> can be used to scale the computed acceleration of the earth radiation.</p><p>The thermal radiation (TRP) of the satellite itself is either computed as direct re-emission or
based on the actual temperature of the satellite surfaces, depending on the seetings of the
<a class="groops-file" href="fileFormat_satelliteModel.html">satellite macro model</a>. The second one uses a transient temperature model
with a temporal differential equation which disallows parallel computing.
The <strong class="groops-config-element">factorThermalRadiation</strong> can be used to scale the computed acceleration of the TRP.</p><p>The algorithms are described in:</p><p>Woeske et. al. (2019), GRACE accelerometer calibration by high precision non-gravitational force modeling,
Advances in Space Research, <a href="https://doi.org/10.1016/j.asr.2018.10.025" target="_blank">https://doi.org/10.1016/j.asr.2018.10.025</a>.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">solarflux</div></div></td><td>double</td><td>solar flux constant in 1 AU [W/m^2]</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">eclipse</div></div></td><td><a href="eclipseType.html">eclipse</a></td><td></td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">inputfileAlbedoTimeSeries</div></div></td><td>filename</td><td>GriddedDataTimeSeries of albedo values (unitless)</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">inputfileLongwaveFluxTimeSeries</div></div></td><td>filename</td><td>GriddedDataTimeSeries of longwave flux values [W/m^2]</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factorSolarRadation</div></div></td><td>double</td><td>Solar radiation pressure is multiplied by this factor</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factorEarthRadation</div></div></td><td>double</td><td>Earth radiation preussure is multiplied by this factor</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factorThermalRadiation</div></div></td><td>double</td><td>Thermal (re-)radiation is multiplied by this factor</td></tr>
</table>

<h2 id="atmosphericDrag">AtmosphericDrag</h2><p>
Atmospheric drag model.
Algorithm for the atmospheric drag modelling is based on the free molecule flow
theory by Sentman 1961. An analytical expression of this treatise is given in
Moe and Moe 2005.</p><p>Sentman L. (1961), Free molecule flow theory and its application to the determination
of aerodynamic forces, Technical report.</p><p>Moe K., Moe M. M. (2005), Gas-surface interactions and satellite drag coefficients,
Planetary and Space Science 53(8), 793-801, doi:10.1016/j.pss.2005.03.005.</p><p>Optional determination steps:
Turn temperature on or off.
In the first case, the model mentioned above is applied, which estimates variable drag
and lift coefficients - in the latter case a constant drag coefficient can be specified.</p><p>Turn wind on/off:
It enables the usage of the Horizontal Wind Model 2014 to add additional thermospheric
winds in the calculation process.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">thermosphere</div></div></td><td><a href="thermosphereType.html">thermosphere</a></td><td></td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">earthRotation</div></div></td><td>double</td><td>[rad/s]</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">considerTemperature</div></div></td><td>boolean</td><td>compute drag and lift, otherwise simple drag coefficient is used</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">considerWind</div></div></td><td>boolean</td><td></td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor</td></tr>
</table>

<h2 id="atmosphericDragFromDensityFile">AtmosphericDragFromDensityFile</h2><p>
Atmospheric drag computed from thermospheric density along the orbit
(<a class="groops-class" href="fileFormat_instrument.html">inputfileDensity</a>, MISCVALUE). The <a class="groops-class" href="thermosphereType.html">thermosphere</a>
is used to to compute temperature and wind.
For further details see <a class="groops-class" href="miscAccelerationsType.html#atmosphericDrag">atmosphericDrag</a>.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfileDensity</div></div></td><td>filename</td><td>density along orbit, MISCVALUE (kg/m^3)</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">thermosphere</div></div></td><td><a href="thermosphereType.html">thermosphere</a></td><td>used to compute temperature and wind</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">earthRotation</div></div></td><td>double</td><td>[rad/s]</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">considerTemperature</div></div></td><td>boolean</td><td>compute drag and lift, otherwise simple drag coefficient is used</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">considerWind</div></div></td><td>boolean</td><td></td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor</td></tr>
</table>

<h2 id="antennaThrust">Antenna thrust</h2><p>
The thrust (acceleration) in the opposite direction the antenna is facing
which is generated by satellite antenna broadcasts.
The thrust is defined in the satellite macro model.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor</td></tr>
</table>

<h2 id="fromParametrization">FromParametrization</h2><p>
Reads a solution vector from file <a class="groops-class" href="fileFormat_matrix.html">inputfileSolution</a>
which may be computed by a least squares adjustment (e.g. by <a class="groops-program" href="NormalsSolverVCE.html">NormalsSolverVCE</a>).
The coefficients of the vector are interpreted from position <strong class="groops-config-element">indexStart</strong>
(counting from zero) with help of <a class="groops-class" href="parametrizationAccelerationType.html">parametrization</a>.
If the solution file contains solution of several right hand sides you can choose
one with number <strong class="groops-config-element">rightSide</strong> (counting from zero).</p><p>The computed result is multiplied with <strong class="groops-config-element">factor</strong>.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset-unbounded">parametrization</div></div></td><td><a href="parametrizationAccelerationType.html">parametrizationAcceleration</a></td><td></td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfileSolution</div></div></td><td>filename</td><td>solution vector</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">indexStart</div></div></td><td>uint</td><td>position in the solution vector</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">rightSide</div></div></td><td>uint</td><td>if solution contains several right hand sides, select one</td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor, set -1 to subtract the field</td></tr>
</table>

<h2 id="group">Group</h2><p>
Groups a set of <a class="groops-class" href="miscAccelerationsType.html">miscAccelerations</a> and has no further effect itself.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional-unbounded">miscAccelerations</div></div></td><td><a href="miscAccelerationsType.html">miscAccelerations</a></td><td></td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor</td></tr>
</table>

<h2 id="solarRadiationPressure">SolarRadiationPressure</h2><p>
DEPRECATED since 2022-12-19. Use radiationPressure instead.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">solarflux</div></div></td><td>double</td><td>solar flux constant in 1 AU [W/m**2]</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">eclipse</div></div></td><td><a href="eclipseType.html">eclipse</a></td><td></td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor, set -1 to subtract the field</td></tr>
</table>

<h2 id="albedo">Albedo</h2><p>
DEPRECATED since 2022-12-19. Use radiationPressure instead.
</p>
<table class="table table-hover">
<tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">inputfileReflectivity</div></div></td><td>filename</td><td></td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">inputfileEmissivity</div></div></td><td>filename</td><td></td></tr>
<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">solarflux</div></div></td><td>double</td><td>solar flux constant in 1 AU [W/m**2]</td></tr>
<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">factor</div></div></td><td>double</td><td>the result is multiplied by this factor, set -1 to subtract the field</td></tr>
</table>

        </div>
    </main>
</body>
</html>
